home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / a / msaaaa.hlp < prev    next >
Encoding:
Text File  |  1993-07-12  |  15.5 KB  |  339 lines
  1. MSAAAA.HLP                    MS-DOS KERMIT                          July 1993
  2.  
  3. This file explains the organization and naming conventions used for the MS-DOS
  4. Kermit files at Kermit Distribution, Columbia University, as they appear on
  5. magnetic tapes and on the network.  The MS-DOS Kermit distribution diskette
  6. uses simpler names, like KERMIT.EXE, KERMIT.HLP, etc.  This disk also contains
  7. a READ.ME file, which is kept in Kermit Distribution as MSVIBM.DSK.  Be sure
  8. to read it.
  9.  
  10. DOCUMENTATION
  11.  
  12.   Christine M. Gianone, "Using MS-DOS Kermit", Second Edition, Digital Press,
  13.   Bedford, MA, 1992, 345 pages.  Packaged with version 3.11 of MS-DOS Kermit
  14.   for the IBM PC, PS/2, and compatibles on a 5.25-inch diskette.
  15.  
  16.     DEC Order Number:   EY-H893E-DP
  17.     Digital Press ISBN: 1-55558-082-3
  18.     Prentice Hall ISBN: 0-13-952276-X
  19.  
  20.     Internation Edition DEC Order Number:     EY-H893E-DI
  21.     Prentice Hall International Edition ISBN: 0-13-953043-6
  22.  
  23.   US single-copy price: $34.95; quantity discounts available.  Available in
  24.   computer bookstores or directly from Digital Press.  In the USA, call
  25.   Digital Press toll-free 1-800-344-4825 to order; major credit cards
  26.   accepted.  Overseas, order through your bookstore or your local Digital
  27.   Equipment Corporation branch.
  28.  
  29.   A German-language edition is also available:
  30.  
  31.     Christine M. Gianone, "MS-DOS Kermit, das universelle
  32.     Kommunikationsprogramm", Verlag Heinz Heise, Hannover, Germany (1991),
  33.     414 pages.  Packaged with version 3.11 of MS-DOS Kermit for the IBM PC,
  34.     PS/2, and compatibles on a 5.25-inch diskette, including German-language
  35.     help files.  Deutsch von Gisbert W. Selke.  Price: DM 69,00.  ISBN
  36.     3-88229-006-4.  Verlag Heinz Heise GmbH & Co. KG, Helstorfer Strasse 7,
  37.     D-3000 Hannover.  Tel. +49 (05 11) 53 52-0, Fax. +49 (05 11) 53 53-1 29.
  38.  
  39.   And a French-language edition:
  40.  
  41.     Christine M. Gianone, "Kermit MS-DOS Mode d'Emploi", Heinz Schiefer & Cie.,
  42.     Versailles (1993), 406 pages.  Packaged with version 3.11 of MS-DOS Kermit
  43.     for the IBM PC, PS/2, and compatibles on a 5.25-inch diskette.  Adaption
  44.     francaise: Jean Dutertre.  ISBN 2-901143-20-2.  Heinz Schiefer & Cie.,
  45.     45 rue Henri de Regnier, F-78000 Versailles.  Tel. +33 13 021 55 05,
  46.     Fax. +33 13 902 3971.
  47.  
  48.   There is also a Japanese book about MS-DOS Kermit:
  49.  
  50.     Dr. Hirofumi Fujii and Mrs. Fukuko Yuasa, "MS-Kermit Nyumon", Computer
  51.     Today, Saiensu-Sha Co., Ltd., publishers (1993), 160 pages.
  52.     Publisher's address: 2-6, Kanda Suda-cho, Chiyoda-ku, Tokyo 101, Japan.
  53.     ISBN 4-7819-0669-9 C3355 P1854E.  Tel. +813 256-1091.
  54.  
  55.   The English-language edition can also be ordered from:
  56.  
  57.     Kermit Development and Distribution
  58.     Columbia University Academic Information Systems
  59.     612 West 115th Street
  60.     New York, NY  10025  USA
  61.     Telephone: (USA) 212 854-3703
  62.  
  63.   Domestic and overseas orders accepted.  Price: $34.95 (US, Canada, and
  64.   Mexico), $45 elsewhere.  Orders may be paid by MasterCard or Visa, or
  65.   prepaid by check in US dollars.  Add $35 bank fee for checks not drawn on a
  66.   US bank.  Price includes shipping.  Do not include sales tax.
  67.  
  68. FILES
  69.  
  70. The files needed for the IBM PC version of MS-DOS Kermit are:
  71.  
  72.   Diskette name  UNIX name               BITNET name     Description
  73. *  KERMIT.EXE     kermit/bin/msvibm.exe    (none)          Executable program
  74.    (none)         kermit/a/msvibm.boo      MSVIBM BOO      BOO'd executable
  75.    MSKERMIT.INI   kermit/a/mskermit.ini    MSKERMIT INI    Initialization file
  76.    MSCUSTOM.INI   kermit/a/mscustom.ini    MSCUSTOM INI    Customization file
  77.    MSKERMIT.PCH   kermit/a/mskermit.pch    MSKERMIT PCH    Patch file
  78.    KERMIT.UPD     kermit/a/mskerm.upd      MSKERM UPD      Update documentation
  79.    KERMIT.HLP     kermit/a/mskerm.hlp      MSKERM HLP      Help file
  80.    KERMIT.BWR     kermit/a/mskerm.bwr      MSKERM BWR      "Beware" file
  81. *  KERMIT.PIF     kermit/bin/msvibm.pif    (none)          Windows PIF file
  82.    (none)         kermit/a/msvpif.boo      MSVPIF BOO      BOO'd IBMPC PIF file
  83.    VT300.INI      kermit/a/msivt3.ini      MSIVT3 INI      VT300 key mappings
  84.    HAYES.SCR      kermit/a/msmhayes.scr    MSMHAYES SCR    Hayes dialing script
  85.    DIALUPS.TXT    kermit/a/msidia.txt      MSIDIA TXT      Sample dialing dir.
  86.  
  87. If you are accessing the these files from the Internet, use binary-mode
  88. anonymous FTP to get the binary files (marked with * above); use text-mode
  89. (ASCII) FTP to get the others.
  90.  
  91. If you don't have access to binary-mode FTP, get the MSVIBM.BOO file instead
  92. and then translate it back into an .EXE file, as explained below in the
  93. Boostrapping section.
  94.  
  95. You may also pick up the entire MS-DOS Kermit distribution diskette in the
  96. form of a binary .ZIP file, which you can unpack with the PKUNZIP program
  97. (if you have it).  Use binary-mode anonymous FTP, and GET the file
  98. kermit/bin/msvibm.zip.
  99.  
  100.     In the rest of this file, we will use the DOS form for filenames.
  101.     For example, MSAAAA.HLP refers to kermit/a/msaaaa.hlp (Internet)
  102.     or MSAAAA HLP (the BITNET copy of the same file).
  103.  
  104. MODEM DIALING SCRIPTS
  105.  
  106. See MSMAAA.HLP (MODEMS.HLP) for details:
  107.  
  108.   Modem Type             DOS Filename  Internet               BITNET/EARN/CREN
  109.    Hayes 1200 or 2400     HAYES.SCR     kermit/a/msmhayes.scr    MSMHAYES SCR
  110.    Hayes Ultra 144        ULTRA144.SCR  kermit/a/msmultra.scr    MSMULTRA SCR
  111.    Multitech MT1432       MT1432.SCR    kermit/a/msmmt1432.scr   MSMMT1432 SCR
  112.    Penril Alliance V.32   PENRIL.SCR    kermit/a/msmpenril.scr   MSMPENRIL SCR
  113.    Practical Peripherals  PP14400.SCR   kermit/a/msmpp14400.scr  MSMPP1440 SCR
  114.    Rolm CBX DCM           ROLM.SCR      kermit/a/msmrolm.scr     MSMROLM SCR
  115.    SupraFAXmodem V.32bis  SUPRA.SCR     kermit/a/msmsupra.scr    MSMSUPRA SCR
  116.    Telebit QBlazer V.32   QBLAZER.SCR   kermit/a/msmqblaz.scr    MSMQBLAZ SCR
  117.    Telebit T3000 V.32bis  T3000.SCR     kermit/a/msmt3000.scr    MSMT3000 SCR
  118.    US Robotics Sportster  SPORT.SCR     kermit/a/msmsport.scr    MSMSPORT SCR
  119.    Vadic VA2400PA         VA2400PA.SCR  kermit/a/msmva2400.scr   MSMVA2400 SCR
  120.  
  121. TCP/IP SUPPORT
  122.  
  123. Basic instructions for setting up and using MS-DOS Kermit's built-in TCP/IP
  124. support can be found in "Using MS-DOS Kermit", with supplemental material in
  125. MSKERM.UPD, MSKERM.HLP, and further hints in MSKERM.BWR.
  126.  
  127. MS-DOS Kermit's built-in TCP/IP support works only with packet drivers or ODI
  128. drivers, and not with board-specific device drivers.  An informative article
  129. about packet drivers by Joe Doupnik can be found in the Info-Kermit Digest,
  130. Volume 14 Number 5, 16 September 1991, available online as file IMAIL.91B.
  131. Columbia University also keeps a copy of the Crynwr packet driver collection
  132. in the packet-drivers/xxx/ directories, where xxx is src (source code), bin
  133. (binaries), doc (documentation), zip (binary ZIP files, as distributed by
  134. Crynwr), and new (items not included in the Crynwr collection).
  135.  
  136. A frequent question is how to convert a Novell network (client workstations
  137. and servers) to use packet drivers so that Novell software can coexist with
  138. Kermit or other network applications.  This is done using a package from
  139. Brigham Young University (BYU).  An explanation is given in the file
  140. packet-drivers/new/msabyu.hlp.
  141.  
  142. OTHER MS-DOS KERMIT FILES
  143.  
  144. MS-DOS Kermit is also available for a wide variety of non-IBM compatible
  145. PCs, and source code is available for all versions.
  146.  
  147. MS-DOS Kermit Distribution file names are all in the following form:
  148.  
  149.     MScxxx.typ
  150.  
  151. The file name should be no longer than six characters, the file type is 3 or
  152. less.  MS is the common prefix for all the file names.
  153.  
  154. "c" is a single-letter code that categorizes the file:
  155.  
  156.   A - General information, "read me" files, etc. (like this file)
  157.   B - Files related to Bootstrapping, .BOO file creation and decoding
  158.   D - Demo files
  159.   E - Terminal-related utilities
  160.   F - File-related utilities
  161.   G - Source code for Graphics terminal emulation
  162.   I - Initialization, command, or script files to be read by MS-DOS Kermit
  163.   K - General program documentation (Kermit User Guide chapter, etc)
  164.   M - Modem-dialing scripts to be executed by MS-DOS Kermit's DIAL macro
  165.   N - Network (TCP/IP) related source files
  166.   O - Like V, but for an Old version
  167.   P - Printer-related files and utilities
  168.   R - Release notes
  169.   S - System-independent Source code (.ASM, .H)
  170.   T - Like V, but for a Test version
  171.   U - System-dependent keyboard handling code, utilities, documentation
  172.   V - Binaries, .BOO files, documentation, etc, for a particular Version
  173.   X - System-dependent source code & related documentation
  174.   Y - System-dependent terminal emulation code
  175.   Z - More system-dependent terminal emulation code (if MSYxxx too big)
  176.  
  177. "xxx" is a 3 letter code to designate which system an MSG, MSU, MSV, MSX, MSY,
  178. or MSZ file applies to:
  179.  
  180.   AAA - An information file
  181.   AP3 - NEC APC-3
  182.   APC - NEC APC
  183.   APR - ACT Apricot
  184.   DM2 - DECmate II or III with MS-DOS Option
  185.   GEN - "Generic" MS-DOS (DOS calls only)
  186.   GRI - Grid Compass II
  187.   HP1 - HP-150
  188.   HPX - HP-110 and HP Portable Plus
  189.   IBM - IBM PC and PS/2 families
  190.   MBC - Sanyo MBC-550
  191.   P98 - NEC PC 9801 (Japanese Kana/Kanji version)
  192.   RB1 - DEC Rainbow-100 series
  193.   RB2 - DEC Rainbow-100 series (special VT220 emulating version)
  194.   RMX - Intel 300 Series with iRMX-86
  195.   SEE - Seequa Chameleon
  196.   TIP - Texas Instruments Professional
  197.   V90 - Victor 9000 (Sirius 1)
  198.   V9T - Victor 9000 (Sirius 1) with Tektronix emulation
  199.   WNG - Wang PC
  200.   Z10 - Heath/Zenith 100
  201. (Others may be added as time goes on.)
  202.  
  203. "typ" is the file type, e.g.
  204.  
  205.   ASM - Assembler source (for Microsoft or IBM Assembler)
  206.   H   - An assembler header file (included at assembly time)
  207.   C   - A C language source file (e.g. Microsoft C)
  208.   BAS - A Basic language source (e.g. Microsoft Basic)
  209.   BOO - An .EXE file encoded into printable characters for bootstrapping 
  210.   BWR - A "beware" file - list of known bugs or limitations
  211.   HLP - A help file
  212.   DOC - A longer documentation file
  213.   ED  - A program edit history file (detailed)
  214.   PS  - Documentation in Postscript format, for laser printer
  215.   MSS - Scribe text formatter source for a HLP or DOC file
  216.   INI - An initialization or command file to be read by Kermit
  217.   SCR - An MS-DOS Kermit script command file
  218.   BAT - An MS-DOS Batch file (e.g. for building MS-DOS Kermit from source)
  219.   MAK - A "makefile" for Microsoft or other MAKE program
  220.   LNK - An MS-DOS Linker command file
  221.   UPD - A program update history file
  222.   TAK - An MS-DOS Kermit command file
  223.   TRM - A UNIX termcap entry to match the program's terminal emulator
  224.   PIF - MS-Windows PIF-file construction instructions
  225.   DSK - A listing of the files on a particular MS-Kermit distribution disk
  226.  
  227. PATCHES
  228.  
  229. Bugs in MS-DOS Kermit are sometimes correctable by runtime patches supplied
  230. in the form of a text file containing changes to be applied to Kermit's program
  231. image by Kermit itself after it starts.  The current patch file for the IBM PC
  232. version of MS-DOS Kermit is MSRxxx.PCH, where xxx is the version number, like
  233. MSR313.PCH.  See MSKERM.HLP for further information.
  234.  
  235. SOURCE CODE
  236.  
  237. The source files have names beginning with MSS and MSN.  They are written in
  238. MASM and Microsoft C.  MASM and C 6.00 are required.  MSVIBM.MAK is the
  239. makefile.  MSSAAA.HLP lists the source files for the IBM PC version.
  240.  
  241. The system-independent source file names all start with MSS --
  242.  
  243.  MSSCMD.ASM  Command parser
  244.  MSSCOM.ASM  Communications (system-independent)
  245.  MSSDEF.H    Symbol definitions for all modules
  246.  MSSFIL.ASM  File i/o
  247.  MSSKER.ASM  Main program
  248.  MSSRCV.ASM  Receive module
  249.  MSSSCP.ASM  Script module
  250.  MSSSEN.ASM  Send module
  251.  MSSSER.ASM  Server module
  252.  MSSSET.ASM  Set command module
  253.  MSSSHO.ASM  Show command module
  254.  MSSTER.ASM  Terminal emulation (system-independent)
  255.  
  256. The program also needs an MSU and an MSX module for the desired system, plus an
  257. MSY module for the same system (if the system has terminal emulation code), and
  258. possibly an MSZ module too, if the MSY module gets too large (as it has for the
  259. IBM PC family), and finally an MSG module if graphics terminal emulation is
  260. also included.  Assembling and linking procedures are described in MSSAAA.HLP.
  261. The MSX, MSY, and other system-dependent files may come with associated HLP or
  262. BWR files.  For the IBM version only, the TCP/IP networking source files are
  263. in MSN*.*.
  264.  
  265. BOOTSTRAPPING
  266.  
  267. Getting MS-DOS Kermit onto an MS-DOS system initially when you don't have a
  268. diskette to read it from, but you do have it on line on another computer...  is
  269. called "bootstrapping."  The method used with MS-DOS Kermit is to download
  270. (somehow) a version of the appropriate .EXE (executable binary) file that has
  271. been encoded in all printable characters by the MSBMKB program into a ".BOO
  272. file" (short for bootstrap).  The BOO file is then decoded on the PC using a
  273. short Basic (or C, or Pascal, or other) program.
  274.  
  275.  MSBAAA.HLP   A brief explanation of the bootstrapping files and procedures
  276.  MSBMKB.C     The "BOO File Maker" (runs on MS-DOS Systems with Lattice C)
  277.  MSBMKB.BOO   BOO file based on MSBMKB.EXE generated from MSBMKB.C
  278.  MSBMKB.*     There are also versions of MSBMKB in assembler, Fortran, etc.
  279.  MSBPCT.BAS   Like MSBPCB.BAS, but assumes the BOO file is already downloaded
  280.  MSBPCT.C     Like MSBPCT.BAS, but written in C for speed
  281.  MSBPCT.BOO   BOO file formed from MSBPCT.EXE based on MSBPCT.C
  282.  MSBPCT.*     There are also versions of MSBPCT in assembler, Fortran, etc.
  283.  MSBRB1.BAS   Like MSBPCB.BAS, but runs under Rainbow CP/M-86 Basic
  284.  MSBRCV.BAS   A short Microsoft BASIC Kermit program, receive-only
  285.  MSV*.BOO     The BOO files for each version of MS-DOS Kermit, e.g. MSVIBM.BOO
  286.  MST*.BOO     The BOO files for a Test (prerelease) version of MS-DOS Kermit
  287.  MSO*.BOO     The BOO files from an Old release of MS-DOS Kermit
  288.  
  289. ONLINE USER DOCUMENTATION
  290.  
  291.  MSKERM.UPD     Updates since "Using MS-DOS Kermit" was published.
  292.  MSKERM.HLP     Help file, summary of MS-Kermit commands and features.
  293.  MSKERM.BWR     List of restrictions and known bugs.
  294.  MSRxxx.UPD     Release notes for Version xxx, e.g. MSR300.UPD.
  295.  MSVIBM.VT      VT terminal emulator technical summary for IBM version.
  296.  MSVIBM.TEK     Graphics terminal emulator technical summary for IBM version.
  297.  MSGTIF.DOC     Aldus/Microsoft Memo describing TIFF graphics file format.
  298.  MSABYU.HLP     Instructions for installing Packet Drivers on Novell networks.
  299.  
  300. INITIALIZATION OR COMMAND FILES
  301.  
  302. MS-DOS Kermit always reads the file MSKERMIT.INI upon startup and executes
  303. the Kermit commands that are in it.  There is also a TAKE command that allows
  304. the user to explicitly direct Kermit to execute commands from a specified
  305. file.  Several sample files are provided (there may also be others, see any
  306. MS*.INI file):
  307.  
  308.  MSKERMIT.INI   Sample MSKERMIT.INI file
  309.  MSKERMIT.PCH   Runtime patches to fix bugs in current IBM version
  310.  MSIEM*.INI     Key mappings for use with EMACS
  311.  MSIRB1.INI     Puts some of the DEC Rainbow's keys in more normal positions.
  312.  MSIVT*.INI     Various key mappings for VT200/300 keyboard emulation.
  313.  MSIWP3.INI     Key mappings for use with mainframe WordPerfect.
  314.  MSI123.INI     Key mappings for use with mainframe Lotus 1-2-3.
  315.  MSIMSW.INI     Key mappings for use with mainframe Microsoft Word.
  316.  
  317. PRINTER PROGRAMS
  318.  
  319. A variety of printer drivers and printer-related programs are available as
  320. MSP*.*.  See MSPAAA.HLP for details.
  321.  
  322. Of special interest are a UNIX shell script and a VAX/VMS command procudure
  323. to do "PC printing" -- i.e. to send a file to the PC's printer.  These are
  324. in MSPUPC.* (UNIX) and MSPVPC.* (VMS).
  325.  
  326. UTILITY PROGRAMS
  327.  
  328. MSIXSE.* = "XSEND", a program that constructs a command file to send an
  329. entire directory tree from one DOS system to another, using Kermit to create
  330. directories on the fly, etc.
  331.  
  332. MSUCHK.* = "SCANCHEK", a program to tell you the keyboard scan codes of the
  333. IBM PC.
  334.  
  335. MSULK2.* - A driver for the DEC LK250 keyboard, which can be plugged into
  336. a PC/AT or compatible.
  337.  
  338. (End of MSAAAA.HLP)
  339.